package com.tju.ocean_ecology_website.service;

import com.tju.ocean_ecology_website.entity.VolunteerCertificate;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;

import java.util.List;

/**
 * 志愿者证书表(VolunteerCertificate)表服务接口
 *
 * @author shaolong
 * @since 2025-05-05 10:00:00
 */
public interface VolunteerCertificateService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    VolunteerCertificate queryById(Long id);

    /**
     * 分页查询
     *
     * @param volunteerCertificate 筛选条件
     * @param pageRequest      分页对象
     * @return 查询结果
     */
    Page<VolunteerCertificate> queryByPage(VolunteerCertificate volunteerCertificate, PageRequest pageRequest);

    /**
     * 新增数据
     *
     * @param volunteerCertificate 实例对象
     * @return 实例对象
     */
    VolunteerCertificate insert(VolunteerCertificate volunteerCertificate);

    /**
     * 修改数据
     *
     * @param volunteerCertificate 实例对象
     * @return 实例对象
     */
    VolunteerCertificate update(VolunteerCertificate volunteerCertificate);

    /**
     * 通过主键删除数据
     *
     * @param id 主键
     * @return 是否成功
     */
    boolean deleteById(Long id);

    /**
     * 根据志愿者ID查询证书
     *
     * @param volunteerId 志愿者ID
     * @param pageRequest 分页对象
     * @return 证书列表
     */
    Page<VolunteerCertificate> queryByVolunteerId(Long volunteerId, PageRequest pageRequest);

    /**
     * 生成证书PDF
     *
     * @param id 证书ID
     * @return PDF文件字节数组
     */
    byte[] generateCertificatePdf(Long id);

    /**
     * 统计符合条件的数据数量
     *
     * @param volunteerCertificate 查询条件
     * @return 数据数量
     */
    long count(VolunteerCertificate volunteerCertificate);
}
